home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / diskdump.zip / DISKDUMP.DOC < prev    next >
Text File  |  1989-03-07  |  3KB  |  77 lines
  1. DISKDUMP.COM - Version 1.02 - Copyright 1989 by Jim Seymour
  2.  
  3.    This program uses BIOS to read the contents of any sector on any
  4. disk device.  The user specifies exactly which sector is to be read.
  5. The output may be in either decimal or hexadecimal, and ASCII or
  6. EBCDIC.  It does not allow modification of the sector, nor can it show
  7. more than one sector at a time.
  8.  
  9.    This software is freely distributable as long as the above copyright
  10. notice retains intact and this document is distributed along with the
  11. program.
  12.  
  13. With no command-line arguments, the following usage summary is shown:
  14. =====================================================================
  15. Usage: DISKDUMP [-eaxdlnwb012] drive cylinder head sector
  16. Copyright 1989 by Jim Seymour
  17. Version 1.02, 7 March 1989
  18.  
  19. Dumps a sector from disk.  Drive must be given in hex: 0=Diskette #1,
  20. 80=Hard Disk #1.  Cylinder, Head, and Sector must be given in decimal
  21. Options are first read from the environment variable DISKDUMP, if it exists.
  22.     -e : show text in EBCDIC
  23.     -a : show text in ASCII (the default)
  24.     -x : show data in hexadecimal (the default)
  25.     -d : show data in decimal (suppresses text if byte grouping)
  26.     -w : show data with word grouping
  27.     -b : show data with byte grouping (the default)
  28.     -l : 132-column output
  29.     -n : 80-column output (the default)
  30.     -0 : show only the first half of the sector
  31.     -1 : show only the last half of the sector
  32.     -2 : show both halves of the sector (the default)
  33.  
  34. If the -d and -w switches are specified, the -e switch forces the
  35. word to be read as high-order, low-order, instead of the normal method
  36. =====================================================================
  37.  
  38.    Options may be specified on the command line, or placed in the environment
  39. variable DISKDUMP.  The environment variable is scanned first, so the command
  40. line switches take precedence.
  41.  
  42. Examples of the various outputs (using the same data) follows:
  43.  
  44. All switches at the default settings:
  45. DISKDUMP -axbn 80 0 0 1
  46. =========================================================================
  47. Drive: 80, Cylinder: 0, Head: 0, Sector: 1
  48. 000: fa 2b c0 8e d0 8e c0 8e | d8 b8 00 7c 8b e0 fb 8b ".+.........|...."
  49. 010: f0 bf 00 7e fc b9 00 01 | f3 a5 e9 00 02 b9 10 00 "...~............"
  50. etc...
  51. =========================================================================
  52.  
  53. Decimal output, byte-grouping:
  54. DISKDUMP -adbn 80 0 0 1
  55. =========================================================================
  56. Drive: 80, Cylinder: 0, Head: 0, Sector: 1
  57. 000: 250  43 192 142 208 142 192 142 | 216 184   0 124 139 224 251 139
  58. 010: 240 191   0 126 252 185   0   1 | 243 165 233   0   2 185  16   0
  59. etc...
  60. =========================================================================
  61.  
  62. Decimal output, word-grouping:
  63. DISKDUMP -adwn 80 0 0 1
  64. =========================================================================
  65. Drive: 80, Cylinder: 0, Head: 0, Sector: 1
  66. 000: 11258 36544 36560 36544 | 47320 31744 57483 35835 ".+.........|...."
  67. 010: 49136 32256 47612   256 | 42483   233 47362    16 "...~............"
  68. etc...
  69. =========================================================================
  70.  
  71. This program was written using Turbo C version 2.0, tiny model.
  72. If there are any questions/comments about this program, please send e-mail
  73. to me at qintar@agora.UUCP.  If that fails, U.S. Mail may be sent to:
  74. P.O. Box 329, North Plains, OR  97133
  75.  
  76.    -Jim Seymour
  77.